.TH luge 1 "2014-04-27" "lua-scriptable GEGL" "User Manual"
.SH NAME
luge \- execute a GEGL graph defined by lua

.SH SYNOPSIS
.B
luge [OPTIONS...] <script> [SCRIPT-OPTIONS...] [ARGUMENT...]
.SH DESCRIPTION
Define a GEGL graph using the lua script \fB<script>\fP and execute it. The
script is a lua program that can use a binding to GEGL to define an image
processing node graph consisting of GEGL nodes. This adds lua scripting
abilities to the construction and execution of GEGL graphs. The primary
application is to define GEGL graphs for collections of images with some
dynamically varying parameters.

.SH OPTIONS
.TP
.B
--help, -h
Display a short option summary.
.TP
.B
--version
Display the version number and exit.
.TP
.B
--verbose, -v
Prints some log messages on standard output.
.TP
.B
--quiet, -q
Disables output to standard output from the luge executable, even error
messages are suppressed. This does not effect the output that the script
might be doing (i.e. a \fBprint\fP statement in the script is still output).
.TP
.B
--opencl
Enable OpenCL processing in GEGL. OpenCL is only available in recent
versions of GEGL (>= 0.3) and it's unstable at best. By default OpenCL is
disabled by luge.

.SH "SCRIPT-OPTIONS"
Script options are options that are given after the script on the command line
and are passed to the script in global variables.
.TP
.B
-<VAR>
VAR becomes a list variable in the lua script. The value 1 is appended to
the list. If multiple \fB-<VAR>\fP options are given each appends an additional
1 to the list.
.TP
.B
-<VAR> <VALUE>, -<VAR>=<VALUE>
VAR becomes a list variable in the lua script. The string value
\fB<VALUE>\fP is
appended to the list. The difference between the two variants (with vs.
without the
equal sign '\fB=\fP' is only relevant if the \fB<VALUE>\fP has a leading
dash. An option like
.IP
.B
-option=-value
.IP
will append the string "-value" to the list \fBoption\fP, whereas
.IP
.B
-option -value
.IP
will be interpreted as two separate options and append a 1 to the variable
\fBoption\fP and a 1 to the variable \fBvalue\fP\.

.TP
.B
ARGUMENT
An argument without a leading dash is passed to the script in the global
variable \fBargs\fP\. To pass a value with a leading dash into args use the
syntax from above to explicitly specify the \fBargs\fP argument:
.IP
.B
-args=-argument-with-leading-dash


.SH BUGS
.SH "SEE ALSO"
.br
The GEGL homepage: http://www.gegl.org/
.br
The Lua homepage: http://www.lua.org/
.SH AUTHOR
Rasmus Hahn <rassahah@googlemail.com>


